home *** CD-ROM | disk | FTP | other *** search
/ Greenhouse Effect Detection Expriment / NASA Greenhouse Effect Detection Expriment 1992 - Disc 2.iso / software / dos / cdf22pc / readme.doc < prev   
Encoding:
Text File  |  1992-02-26  |  7.9 KB  |  181 lines
  1.                       CDF Version 2.2, UNIX Systems
  2.  
  3. Common Data Format (CDF) is a conceptual data abstraction for storing
  4. multi-dimensional data sets.  The basic component of CDF is a software
  5. programming interface that is a device independent view of the CDF data
  6. model.  The application developer is insulated from the actual physical
  7. file format for reasons of conceptual simplicity, device independence,
  8. and future expandability.  Version 2 of CDF has been rewritten to be
  9. portable across a wide variety of platforms.  CDF files created on any
  10. given platform can be transported to any other platform on to which CDF
  11. is ported and used with any CDF tools or layered applications.  A more
  12. detailed introduction to CDF can be found in the CDF User's Guide.
  13.  
  14. The CDF library and toolkit programs are written in C.  A C compiler (ANSI
  15. standard preferred) is necessary to build the CDF distribution.  The CDF
  16. distribution also contains several FORTRAN source files which support the
  17. FORTRAN interface.  If a FORTRAN compiler is not available, contact CDF
  18. User Support for the necessary patches.
  19.  
  20. Documentation for CDF consists of the CDF User's Guide.  This document has
  21. been written using LaTeX and can be found in the 'doc' directory of the
  22. distribution area in a compressed "Adobe" PostScript file named ug.ps.Z.
  23. It should be printable on any PostScript printer capable of printing "Abode"
  24. PostScript.  If you have trouble printing the CDF User's Guide, contact us
  25. (we can mail you a hard copy if necessary).  The document will be printed so
  26. that you can copy it to double-sided and then bind it like a book.  Before
  27. printing, you must first uncompress the document with the 'uncompress' command
  28. (which will rename the file ug.ps).
  29.  
  30. Requests for assistance or documentation should be sent to:
  31.  
  32.   Internet -- CDFSUPPORT@NSSDCA.GSFC.NASA.GOV (128.183.36.23)
  33.  
  34. If you get the distribution, please send CDFSUPPORT a message so we can put
  35. you on our mailing list.  That way you will be notified of new releases.
  36.  
  37. UNIX Installation Instructions
  38. ------------------------------
  39.  
  40. CDF V2.2 is distributed for UNIX-based systems as a compressed tar file named
  41. cdf22-dist.tar.Z.  Use the 'uncompress' command to first uncompress the tar
  42. file.  An example of this would be:
  43.  
  44.      uncompress cdf22-dist.tar.Z
  45.  
  46. Then use the 'tar' command to extract the CDF library and toolkit source files
  47. from the tar file.  'tar' will create a directory named 'cdf22-dist' containing
  48. several subdirectories.  The source files for the distribution will be placed
  49. into these directories.
  50.  
  51. The syntax for the 'tar' command is different on some flavors of UNIX.  For
  52. Sun/SunOS, DECstation/ULTRIX, SGi/IRIX, and HP9000/HP-UX use:
  53.  
  54.      tar -xvof cdf22-dist.tar
  55.  
  56. For the IBM-RS6000/AIX use:
  57.  
  58.      tar -x -v -f cdf22-dist.tar
  59.  
  60.  
  61. CDF V2.2 has a makefile setup to automatically build the CDF library and
  62. tools.  The following steps should be taken to build and install CDF V2.2.
  63.  
  64.         1. Set your current directory (cd) to the top level CDF directory
  65.            (the directory named 'cdf22-dist' created by 'tar').
  66.  
  67.         2. This step depends on your machine/operating system.  It will
  68.            compile and link the distribution.
  69.  
  70.              For a Sun/SunOS 4.1 (or newer) installation enter:
  71.  
  72.                 make all.Sun_SunOS
  73.  
  74.  
  75.              For a Sun/SunOS 4.0.3 (or older) installation enter:
  76.  
  77.                 make all.Sun_SunOS_403
  78.  
  79.  
  80.              For a Silicon Graphics/IRIX installation enter:
  81.  
  82.                 make all.SGi_IRIX
  83.  
  84.  
  85.              For a DECstation/ULTRIX installation enter:
  86.  
  87.                 make all.DECstation_ULTRIX
  88.  
  89.  
  90.              For an IBM-RS6000/AIX installation enter:
  91.  
  92.                 make all.IBM-RS6000_AIX
  93.  
  94.              For an HP9000/HP-UX installation enter:
  95.  
  96.                 make all.HP9000_HP-UX
  97.  
  98.  
  99.            Some informational/warning messages may be displayed.  These can
  100.            be ignored and should have no effect on the operation of the
  101.            library or toolkit programs.
  102.  
  103.         3. Test that the distribution was built correctly by entering the
  104.            appropriate command from the following:
  105.  
  106.                 make test.Sun_SunOS
  107.                 make test.Sun_SunOS_403
  108.                 make test.SGi_IRIX
  109.                 make test.DECstation_ULTRIX
  110.                 make test.IBM-RS6000_AIX
  111.                 make test.HP9000_HP-UX
  112.  
  113.            The CDF release, copyright notice, and CDF_OK status message should
  114.            be displayed for each interface tested.
  115.  
  116.         4. Either install the library, include files, and toolkit programs in
  117.            system directories manually or use 'make' to automatically install
  118.            them.  Using 'make' is dependent on your machine/operating system.
  119.            Enter the appropriate command from the following:
  120.  
  121.              make install.Sun_SunOS         INSTALLDIR=<destination-directory>
  122.              make install.Sun_SunOS_403     INSTALLDIR=<destination-directory>
  123.              make install.SGi_IRIX          INSTALLDIR=<destination-directory>
  124.              make install.DECstation_ULTRIX INSTALLDIR=<destination-directory>
  125.              make install.IBM-RS6000_AIX    INSTALLDIR=<destination-directory>
  126.              make install.HP9000_HP-UX      INSTALLDIR=<destination-directory>
  127.  
  128.            The automatic install creates 'bin', 'include', and 'lib'
  129.            directories in the <destination-directory> to install relevant
  130.            files.  <destination-directory> MUST be an absolute path.
  131.            The executables, include files, and library installed in
  132.            these directories should be used by your applications.  If this
  133.            does not fit in with your system directory setup, then you should
  134.            manually install the CDF library, tools, and include files.
  135.  
  136.            For example (assuming a Sun/SunOS 4.1 system) to install from the
  137.            top level CDF directory, the following command will work if entered
  138.            while in that directory (`pwd` is expanded to be the absolute path
  139.            of the current directory).
  140.  
  141.                 make install.Sun_SunOS INSTALLDIR=`pwd`
  142.  
  143.         5. The environment variable CDF_HELP (use setenv) should be set to
  144.            the location of the 'cdf22-dist/help' directory (full pathname
  145.            needed).  This directory contains the online help text for the
  146.            toolkit programs.  The contents of the 'cdf22-dist/help' directory
  147.            may be moved as long as CDF_HELP is set to the new location.
  148.  
  149.         6. This step is optional but may be desirable.
  150.  
  151.            Set up aliases for the toolkit programs.  Suggested aliases
  152.            and their corresponding values follow.
  153.  
  154.                 cdfbrowse        <dir>/bin/cdfbrow
  155.                 cdflist          <dir>/bin/cdflist
  156.                 cdfwalk          <dir>/bin/cdfwalk
  157.                 cdfconvert       <dir>/bin/cdfcvt
  158.                 cdfskeleton      <dir>/bin/skt2cdf
  159.                 skeletontable    <dir>/bin/cdf2skt
  160.                 cdfinquire       <dir>/bin/cdfinq
  161.                 cdfstats         <dir>/bin/cdfstats
  162.                 cdfcompare       <dir>/bin/cdfcmp
  163.                 cdfscope         <dir>/bin/cdfscope
  164.                 cdfdir           <dir>/bin/cdfdir
  165.  
  166.            <dir> is the directory specified in step 4 if the automatic
  167.            install was used.  These aliases can then be used to execute
  168.            the toolkit programs.
  169.  
  170.            An alternative method would be to add <dir>/bin to your PATH
  171.            environment variable.  In this case, you would have to use the
  172.            executable names found in that directory (which in some instances
  173.            would not agree with the names in the documentation).
  174.  
  175.            A file named 'definitions.template' exists in the top-level
  176.        directory of the CDF distribution.  It is a template for a
  177.        script file that a user could execute to set up some useful
  178.        environment variables and the aliases just described.  You
  179.        may want to edit (and rename) this template and then have CDF
  180.        users on your system execute it when they want to use CDF.
  181.